home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 14 / CU Amiga Magazine's Super CD-ROM 14 (1997)(EMAP Images)(GB)(Track 1 of 3)[!][issue 1997-09].iso / CUCD / Programming / Mesa-2.2 / widgets-mesa / man / MesaWorkstation.pod < prev   
Encoding:
Text File  |  1997-01-31  |  4.0 KB  |  188 lines
  1. =head1 NAME
  2.  
  3. MesaWorkstation - A simple workstation abstraction widget for Mesa/X
  4.  
  5. =head1 DESCRIPTION
  6.  
  7. =head1 Resources
  8.  
  9. The following X resources are available in addition to the B<MesaDrawingArea>
  10. resources:
  11.  
  12.   ___________________________________________________________________________
  13.   |                    |                    |         |                      |
  14.   | Name               | Class              | Type    | OpenGL attribute     |
  15.   |____________________|____________________|_________|______________________|
  16.   |                    |                    |         |                      |
  17.   |                    |                    |         |                      |
  18.   |____________________|____________________|_________|______________________|
  19.  
  20.  
  21. =over 4
  22.  
  23. =back
  24.  
  25. =head1 Actions
  26.  
  27. =over 4
  28.  
  29. =item Projection ()
  30.  
  31. =item Move ()
  32.  
  33. =back
  34.  
  35. =head1 Translations
  36.  
  37. =over 4
  38.  
  39. =item ~Shift<Key>Left: I<Move(l)>
  40.  
  41. =item Shift<Key>Left: I<Move(l,10)>
  42.  
  43. =item ~Shift<Key>Right: I<Move(r)>
  44.  
  45. =item Shift<Key>Right: I<Move(r,10)>
  46.  
  47. =item ~Shift<Key>Up: I<Move(u)>
  48.  
  49. =item Shift<Key>Up: I<Move(u,10)>
  50.  
  51. =item ~Shift<Key>Down: I<Move(d)>
  52.  
  53. =item Shift<Key>Down: I<Move(d,10)>
  54.  
  55. =item <Key>plus: I<Move(+)>
  56.  
  57. =item <Key>minus: I<Move(-)>
  58.  
  59. =item ~Shift<Key>l: I<Projection(l)>
  60.  
  61. =item Shift<Key>l: I<Projection(L)>
  62.  
  63. =item ~Shift<Key>r: I<Projection(r)>
  64.  
  65. =item Shift<Key>r: I<Projection(R)>
  66.  
  67. =item ~Shift<Key>b: I<Projection(b)>
  68.  
  69. =item Shift<Key>b: I<Projection(B)>
  70.  
  71. =item ~Shift<Key>t: I<Projection(t)>
  72.  
  73. =item Shift<Key>t: I<Projection(T)>
  74.  
  75. =item ~Shift<Key>n: I<Projection(n)>
  76.  
  77. =item Shift<Key>n: I<Projection(N)>
  78.  
  79. =item ~Shift<Key>f: I<Projection(f)>
  80.  
  81. =item Shift<Key>f: I<Projection(F)>
  82.  
  83. =item ~Shift<Key>a: I<Projection(a)>
  84.  
  85. =item Shift<Key>a: I<Projection(A)>
  86.  
  87. =item <Key>p: I<Projection(p)>
  88.  
  89. =item <Key>o: I<Projection(o)>
  90.  
  91. =back
  92.  
  93. =head1 Utility functions
  94.  
  95. The following utility functions are available
  96.  
  97. =over 4
  98.  
  99. =item void GLwBeginProjection (Widget w)
  100.  
  101. =item void GLwEndProjection (void)
  102.  
  103. The following code snippet selects perspective projection for the
  104. workstation I<ws>:
  105.  
  106.     GLwBeginProjection (ws);
  107.       glFrustum (-1.0, 1.0, -1.0, 1.0, 1.0, 10.0);
  108.     GLwEndProjection ();
  109.  
  110. During redisplay, this will be executed as a display list with the
  111. matrix mode set to I<GL_PROJECTION> and an identity matrix on top of
  112. the projection matrix stack.
  113.  
  114. =item void GLwPostProjectionList (Widget w, GLuint p)
  115.  
  116. =item void GLwPostProjectionMatrix (Widget w, GLdouble *m)
  117.  
  118. =item void GLwPostCurrentProjection (Widget w)
  119.  
  120. =item void GLwUnpostProjection (Widget w)
  121.  
  122. =item GLuint GLwGetProjectionList (Widget w)
  123.  
  124. =item int GLwGetProjectionMatrix (Widget w, GLdouble *m)
  125.  
  126. =item void GLwSetFrustumProjection (Widget w, GLdouble left, GLdouble right,
  127.     GLdouble bottom, GLdouble top, GLdouble near, GLdouble far)
  128.  
  129. =item void GLwSetOrthoProjection (Widget w, GLdouble left, GLdouble right,
  130.     GLdouble bottom, GLdouble top, GLdouble near, GLdouble far)
  131.  
  132. =item void GLwBeginView (Widget w)
  133.  
  134. =item void GLwEndView (void)
  135.  
  136. The following code snippet selects a view from the z-axis for the
  137. workstation I<ws>:
  138.  
  139.     GLwBeginView (ws);
  140.       gluLookAt (0.0, 0.0, 3.0,
  141.              0.0, 0.0, 0.0,
  142.              0.0, 1.0, 0.0);
  143.     GLwEndView ();
  144.  
  145. During redisplay, this will be executed as a display list with the
  146. matrix mode set to I<GL_MODELVIEW> and an identity matrix on top of
  147. the model view matrix stack.
  148.  
  149. =item void GLwPostViewList (Widget w, GLuint v)
  150.  
  151. =item void GLwPostViewMatrix (Widget w, GLdouble *m)
  152.  
  153. =item void GLwPostCurrentView (Widget w)
  154.  
  155. =item void GLwUnpostView (Widget w)
  156.  
  157. =item GLuint GLwGetViewList (Widget w)
  158.  
  159. =item int GLwGetViewMatrix (Widget w, GLdouble *m)
  160.  
  161. =item void GLwSetPolarView (Widget w, GLdouble r, GLdouble theta, GLdouble phi)
  162.  
  163. =item void GLwPostObject (Widget w, GLuint o)
  164.  
  165. posts I<object> to I<w>.
  166.  
  167. =item void GLwUnpostObject (Widget w, GLuint o)
  168.  
  169. =item void GLwUnpostAllObjects (Widget w)
  170.  
  171. =item void GLwRedrawObjects (Widget w)
  172.  
  173. force a redraw of all objects posted to I<w>.
  174.  
  175. =back
  176.  
  177. =head1 SEE ALSO
  178.  
  179. L<GLwDrawingArea>, L<MesaDrawingArea>
  180.  
  181. =head1 AUTHOR
  182.  
  183. Thorsten.Ohl @ Physik.TH-Darmstadt.de
  184.  
  185. =head1 DATE
  186.  
  187. $Id: MesaWorkstation.pod,v 1.6 1995/05/19 20:31:00 ohl Exp $
  188.